/**
 * OSAmI: Open Source Ambient Intelligence
 * A simple publish/subscribe/dispatch API (based on multicast communications) for constrained devices.
 * Copyright (C) Lionel Debroux 2006 (as a TER/Magistere M1 student in the LSR-IMAG-ADELE team, for a demo in the H-Omega project)
 * Copyright (C) Lionel Debroux 2010 (as an engineer in the LCIS-INPG-CTSYS team, for a pre-demo in the FR part of the OSAMI project)
 * Contact: osami-general@osami-commons.org
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation;
 * version 2.1 of the License.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Suite 500 Boston, MA 02110-1335 USA
 */

package fr.imag.adele.homega.impl.unicast;

import java.io.IOException;

/**
 * API used by bundles representing devices.
 */
public interface UnicastReceiver {
	/**
	 * Callback: receive a multicast message on given topic.
	 */
	public abstract void receive(String topic, String message) throws IOException;

	/**
	 * Tell the receiver to register itself to the given handler, for receiving multicast messages on given topic and port.
	 */
	public abstract void register(UnicastHandler handler, String topic, int port);

	/**
	 * Tell the receiver to unregister itself from the given topic and port, registered on the given handler.
	 */
	public abstract void unregister(UnicastHandler handler, String topic, int port);

	/**
	 * Shutdown this receiver.
	 */
	public void shutdown();
}
